home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 015a / sfc33.zip / SFC.USR < prev    next >
Text File  |  1992-02-09  |  55KB  |  1,522 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                         Serial File Copy
  7.  
  8.  
  9.  
  10.  
  11.                            Version 3.3
  12.  
  13.                            February 1992
  14.  
  15.  
  16.  
  17.  
  18.                     This software is provided as-is.
  19.               There are no warranties, expressed or implied.
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                     Copyright (C) 1989,1990,1991,1992
  26.                     By MarshallSoft Computing, Inc.
  27.                     All rights are reserved.
  28.  
  29.  
  30.  
  31.  
  32.                       MarshallSoft Computing, Inc.
  33.                       Post Office Box 4543
  34.                       Huntsville, AL. 35815
  35.                       (205) 881-4630 5-8PM CST M-F
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.       Users Manual                                           page 1
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.                         TABLE OF CONTENTS
  73.  
  74.  
  75.  
  76.       Chapter                                         Page
  77.       -------                                         ----
  78.  
  79.         1.0  Introduction.............................  3
  80.         2.0  Summary of SFC Features..................  3
  81.         3.0  Distribution Files.......................  4
  82.         4.0  Null Modem Cables........................  5
  83.              4.1 Purchasing a Null Modem Cable........  5
  84.              4.2 Building a Null Modem Cable..........  5
  85.         5.0  Serial COM Ports.........................  7
  86.         6.0  Running SFC..............................  8
  87.              6.1  Startup Menu........................  9
  88.              6.2  Startup Problems.................... 10
  89.              6.3  Status Window....................... 11
  90.              6.4  Command Menu........................ 12
  91.              6.5  Terminating SFC..................... 13
  92.              6.6  CRC Calculations.................... 13
  93.         7.0  Support Programs......................... 14
  94.              7.1  CLONE, GETSFC, and PUTSFC........... 14
  95.              7.2  LOOPBACK............................ 14
  96.              7.3  TERM................................ 14
  97.              7.4  MODEM............................... 14
  98.              7.5  PORTEXAM............................ 14
  99.              7.6  CHECKCRC............................ 15
  100.              7.7  GETFILE and PUTFILE................. 15
  101.              7.8  DRIVES.............................. 16
  102.              7.9  SETCOM3 and SETCOM4................. 16
  103.              7.10 FLAGS............................... 16
  104.         8.0  Performance.............................. 17
  105.              8.1  Test Results........................ 17
  106.              8.2  Other Tests......................... 17
  107.         9.0  Using SFC to back up HARD DISKS.......... 18
  108.        10.0  User Registration........................ 19
  109.        11.0  Revision History......................... 20
  110.        12.0  Other MarshallSoft Products.............. 22
  111.              12.1  Personal Comm Library for C........ 22
  112.              12.2  Personal Comm Library for Pascal... 22
  113.        13.0  License.................................. 23
  114.        14.0  Warranty................................. 23
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.       Users Manual                                           page 2
  132.  
  133.  
  134.  
  135.  
  136.        1.0 Introduction
  137.  
  138.        The Serial File Copy program SFC is designed to allow the transfer
  139.        of  disk files ( including entire directories which may themselves
  140.        contain directories ) between any two IBM PC compatible  computers
  141.        using standard RS232 serial ports. The SFC program is particularly
  142.        useful  in  copying  files  between  IBM PC compatibles with 5.25"
  143.        disks and those with 3.5" disks such  as  the  IBM  PS/2  and  the
  144.        various  IBM PC compatible laptops. The computers must both be IBM
  145.        PC compatible ( this includes the TANDY 1000 ) with 256 KB or more
  146.        of RAM.  SFC is also an easy way to backup a hard  disk  onto  the
  147.        hard disk of another computer.
  148.  
  149.        Both  computers  ( between which you want to transfer files ) must
  150.        have RS232 serial ports configured for use with  a  modem.   COM1,
  151.        COM2,  COM3  or  COM4  may be used. Baud rate of 1200, 2400, 4800,
  152.        9600, 19200, 38400, or 115200 may be selected.
  153.  
  154.  
  155.        2.0 Summary of SFC Features
  156.  
  157.            o Supports COM1, COM2, COM3 and COM4.
  158.            o Supports baud rates from 1200 to 115200.
  159.            o Select groups of files with DOS wildcards ( eg: *.DOC )
  160.            o Select entire directories ( recursively ).
  161.            o Complete disk & transfer status on screen.
  162.            o On line help provided for all SFC commands.
  163.            o Option to send only files with a later timestamp.
  164.            o Option to send only files with ARCHIVE attribute set.
  165.            o Option to send files with READ ONLY attribute set.
  166.            o Load DOS Shell from within SFC.
  167.            o Full 16 bit CRC checksum is used.
  168.            o Bad file packets are automatically retransmitted.
  169.            o Change logged drive and path from within SFC.
  170.            o Display directories from within SFC.
  171.            o File date & time preserved after copying.
  172.            o Supports batch file lists ( lists of files to send ).
  173.            o Option to send or skip any file from selected group.
  174.            o Can print files on remote computer.
  175.            o Choice of B&W or color displays.
  176.            o Can save choices in configuration file.
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.       Users Manual                                           page 3
  198.  
  199.  
  200.  
  201.  
  202.        3.0 Distribution Files
  203.  
  204.        If a previous version of SFC is  used  to  copy  the  distribution
  205.        files  be  sure  to  rename the older version ( eg: rename sfc.exe
  206.        sfc_old.exe ) so that there is no attempt to run the older version
  207.        with the newer version. The following files should be on  the  SFC
  208.        distribution disk:
  209.  
  210.         SFC.EXE  --  The executable Serial File Copy ( SFC ) program.
  211.         SFC.USR  --  The SFC Users Manual.
  212.         SFC.HLP  --  File required for on-line help ( Type F1 for help ).
  213.         SFC.QRC  --  Quick reference card.
  214.         SFC.CFG  --  SFC configuration file.
  215.         SFC.INV  --  Invoice ready to print (shareware only).
  216.         SFCSW.EXE -  Displays shareware screen for SFC (shareware only).
  217.  
  218.        Registered  users  are  also  provided  with the following support
  219.        programs. None are necessary in order to run SFC, but are provided
  220.        as a "Thank You" for registering.   For  a  description  of  these
  221.        programs see the section on "Support Programs".
  222.  
  223.        CLONE.COM    -- 'Clones' SFC on the target computer.
  224.        CLONE.DOC    -- CLONE documentation file.
  225.        GETSFC.COM   -- Created by CLONE on the target computer.
  226.        PUTSFC.COM   -- Sends SFC to GETSFC on the target computer.
  227.        LOOPBACK.COM -- Performs loopback testing on specified port.
  228.        TERM.EXE     -- Simple communications program.
  229.        MODEM.EXE    -- Controls and displays modem control status.
  230.        PORTEXAM.EXE -- Displays all information about specified port.
  231.        CHECKCRC.EXE -- Computes the CRC for any file.
  232.        DRIVES.EXE   -- Displays disk drive usage for range of drives.
  233.        SETCOM3.COM  -- Installs COM3 address ( 3E8 ) in BIOS table.
  234.        SETCOM4.COM  -- Installs COM4 address ( 2E8 ) in BIOS table.
  235.        FLAGS.EXE    -- Examine, sets, or clears file attributes.
  236.        GETFILE.COM  -- Copies files from PUTFILE using BIOS calls only.
  237.        PUTFILE.COM  -- Copies files to GETFILE using BIOS call only.
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.       Users Manual                                           page 4
  264.  
  265.  
  266.  
  267.  
  268.        4.0  Null Modem Cables
  269.  
  270.        A  'null  modem  cable'  is  necessary  to  connect  two computers
  271.        together using the RS232 modem ports. They are widely available or
  272.        can be home built for less than $10.
  273.  
  274.        4.1  Purchasing a Null Modem Cable
  275.  
  276.        A null modem cable can be  purchased  ready  for  use  or  can  be
  277.        assembled  by  connecting a 'null modem adapter' to a normal RS232
  278.        modem cable. Null modem adapters and cables can be purchased  from
  279.        several  sources  such  as  Radio Shack and most electronics parts
  280.        houses. "Computer Shopper" regularly  carries  advertisements  for
  281.        null modem adapters and cables. Be advised that not all null modem
  282.        adapters  and  cables connect all the lines that may be necessary.
  283.        Although all should work for SFC some may not work for  the  MSDOS
  284.        CTTY command which is used by the CLONE program.
  285.  
  286.        4.2 Building a Null Modem Cable
  287.  
  288.        Building  the  null  modem  cable is easy. The only tricky part is
  289.        being absolutely positive that you  have  identified  the  correct
  290.        pins.  Refer to the diagrams below as necessary. The pin numbering
  291.        is shown for the front of each connector, where the pins ( male  )
  292.        or  holes ( female ) are located. When viewed from the back side (
  293.        where the wires are soldered ) the  pins  and  holes  run  in  the
  294.        opposite  direction. Soldering is recommended, although solderless
  295.        connectors which use crimp pins can be used instead. You can  also
  296.        solder  each wire to a crimp pin as its much easier than soldering
  297.        the wire directly onto the connector.
  298.  
  299.  
  300.                          Male DB 25                       Male DB 9
  301.          *****************************************    *****************
  302.        *  1  2  3  4  5  6  7  8  9 10 11 12 13  *  *  1  2  3  4  5  *
  303.         *  14 15 16 17 18 19 20 21 22 23 24 25  *    *   6  7  8  9  *
  304.          ***************************************      ***************
  305.  
  306.  
  307.                         Female DB 25                     Female DB 9
  308.         *****************************************    *****************
  309.        * 13 12 11 10  9  8  7  6  5  4  3  2  1  *  *  5  4  3  2  1  *
  310.         *   25 24 23 22 21 20 19 18 17 16 15 14 *    *   9  8  7  6  *
  311.          ***************************************      ***************
  312.  
  313.         DB 25   DB 9    Pin Definition
  314.         =====   ====    ==============
  315.           7       5      Signal Ground ( SG )
  316.           2       3      Transmit Data ( TX )
  317.           3       2      Receive Data ( RX )
  318.          20       4      Data Terminal Ready ( DTR )
  319.           6       6      Data Set Ready ( DSR )
  320.           4       7      Request to Send ( RTS )
  321.           5       8      Clear to Send ( CTS )
  322.           8       1      Carrier Detect ( CD )
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.       Users Manual                                           page 5
  330.  
  331.  
  332.  
  333.  
  334.        SFC itself requires only signal ground (SG),  transmit  (TX),  and
  335.        receive  (RX)  lines  in  order  to operate.  The first step is to
  336.        determine the type of  connectors  required.   Examine  the  RS232
  337.        connectors on your computers. You will need to purchase connectors
  338.        that  mate  with  the computers connectors.  For example, lets say
  339.        that you have a laptop with a male DB 9 connector  and  a  desktop
  340.        with  a  female DB 25 connector. Then you need a female DB 9 and a
  341.        male DB 25 connector for your cable. IBM ATs and laptops require a
  342.        female DB 9 to mate while most XT class machines require a  female
  343.        DB 25 to mate.
  344.  
  345.        The DB 25 and DB 9 connectors can be purchased at most electronics
  346.        parts  houses.   Radio  Shack  also  stocks  both  solder type and
  347.        solderless DB connectors.
  348.  
  349.        Next you will need about 6 feet of  ordinary  4-wire  solid  phone
  350.        cable,  although  any  3-wire  cable  of  24  to  20  gauge can be
  351.        substituted. If the CLONE program is to be used then 5  wires  are
  352.        required.   Up  to 50 feet of cable can be used. Shielded cable is
  353.        even better but not necessary. Cable can be purchased by the  foot
  354.        at most stores that sell it.
  355.  
  356.        Once the connectors and cable have been purchased you are ready to
  357.        assemble  your null modem cable. First connect the signal ground (
  358.        SG ) line straight between connectors. Then connect Transmit  Data
  359.        (  TX ) from one connector to Receive Data ( RX ) on the other. If
  360.        you wish to use the  SFC  cloning  program  CLONE  you  must  also
  361.        connect  Data Terminal Ready ( DTR ) from the end connected to the
  362.        computer running CLONE to Data Set Ready ( DSR ) on the other end.
  363.        Some computers ( like my TANDY 3000 ) also require you to  connect
  364.        Request  To  Send  (  RTS ) from the end connected to the computer
  365.        running CLONE to Clear To Send ( CTS ) on the other end.
  366.  
  367.        You then should have either 3 ( or 5 in order to use CLONE ) lines
  368.        connected between connectors. Once completed, test the TX  and  RX
  369.        connections  by  running  the  TERM  (  or any terminal emulator )
  370.        program on both sides. Whatever is typed on one side is  displayed
  371.        on  the  other. Finally, test the remaining connections by cloning
  372.        SFC from one computer to the other.
  373.  
  374.        Refer to the Pin Definition Table above in order to  identify  the
  375.        correct  pins  for your connector. When viewing the connector side
  376.        of both the DB 9 and DB 25 with the wide part at the top, the pins
  377.        are numbered left to right, top to bottom.  Most  connectors  have
  378.        the pin numbers on the connector itself but are often difficult to
  379.        read because they are very small.
  380.  
  381.        If   you  have  never  soldered  before,  you  should  use  either
  382.        solderless connectors ( you crimp the wires on ) or find a  friend
  383.        who  has  some  experience  soldering.   Remember  that  soldering
  384.        doesn't have to be pretty in order to  work.   Practice  a  little
  385.        first  with  some  spare wire if you are out of practice. When you
  386.        have completed construction of your null modem cable, verify  that
  387.        the  correct  pins  have  been connected. If you cannot get SFC to
  388.        operate, then most likely you made a mistake in constructing  your
  389.        cable.
  390.  
  391.  
  392.  
  393.  
  394.  
  395.       Users Manual                                           page 6
  396.  
  397.  
  398.  
  399.  
  400.        5.0 Serial COM Ports
  401.  
  402.  
  403.        IBM  PC  compatible  computers  can have up to four or more serial
  404.        ports.  The BIOS table located at address  40:0000  has  room  for
  405.        four communication port addresses -- COM1 to COM4. During boot up,
  406.        the COM1 and COM2 addresses are placed in the BIOS table providing
  407.        that  the  hardware  is  present. Unfortunately, the COM3 and COM4
  408.        addresses are not placed in the table in DOS versions before  3.3.
  409.        This  oversight  can  be  corrected by using DEBUG to assemble the
  410.        following  program  SETCOM3  which  should   be   added   to   the
  411.        AUTOEXEC.BAT  file.   When  executed,  this program will place the
  412.        standard COM3 port address 03E8 in  the  BIOS  table.   For  COM4,
  413.        change 03E8 to 02E8 and [0004] to [0006].
  414.  
  415.  
  416.  
  417.                    PUSH DS
  418.                    MOV AX,0040
  419.                    MOV DS,AX
  420.                    MOV AX,03E8
  421.                    MOV [0004],AX
  422.                    POP DS
  423.                    MOV AX,4C00
  424.                    INT 21
  425.  
  426.  
  427.        If  you  have  never  used  DEBUG,  refer to your MSDOS manual for
  428.        detailed instructions.  SETCOM3.COM and SETCOM4.COM  are  provided
  429.        with the registered version of SFC.
  430.  
  431.        For  example,  if your computer is configured with COM1, COM2, and
  432.        COM3 but not COM4, put SETCOM3.COM ( but not  SETCOM4.COM  )  into
  433.        your  AUTOEXEC.BAT file so that it is run when your computer boots
  434.        up.
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.       Users Manual                                           page 7
  462.  
  463.  
  464.  
  465.  
  466.        6.0 Running SFC
  467.  
  468.        To  begin,  you  will  need SFC loaded onto both computers between
  469.        which you want to copy files. If one computer has  a  5.25"  drive
  470.        and the other has a 3.5" drive but you have SFC on only one disk ,
  471.        then  you  have  2  options:  (1)  You  can  use a general purpose
  472.        communications program such as PROCOMM, QMODEM, or TELIX  to  copy
  473.        the  SFC  files  from  one machine to the other, or (2) registered
  474.        users can use the SFC CLONE.COM program ( See Appendix A ).
  475.  
  476.        Connect your PC compatible computers together with  a  null  modem
  477.        cable  between  the RS232 ports ( the port used to talk to a modem
  478.        ).  Be sure that you are using a proper null  modem  cable  rather
  479.        than a standard cable.
  480.  
  481.        Normally,  SFC can be started on both computers by typing 'SFC' on
  482.        each.  This is referred to  as  the  AUTOSYNC  startup.   On  some
  483.        computers,  AUTOSYNC  will not work well. In this case, choose one
  484.        computer to be the MASTER and the other the SLAVE.   It  makes  no
  485.        difference  which is which. Start SFC on the MASTER by typing "SFC
  486.        M" followed by the ENTER key. Start SFC on  the  SLAVE  by  typing
  487.        "SFC S" followed by the ENTER key. If AUTOSYNC is specified on one
  488.        side, it must also be specified on the other.
  489.  
  490.        When  SFC  starts  up,  it  looks  for  the SFC configuration file
  491.        SFC.CFG in the current directory.  If it is not  there,  it  looks
  492.        for  the  SFC  environment  variable  "SFC=".   If the environment
  493.        variable exists, SFC will use it to find the  configuration  file.
  494.        For example, suppose that SFC.EXE, SFC.HLP, and SFC.CFG are in the
  495.        C:\DOS directory. If you have previously typed
  496.  
  497.                     SET SFC=C:\DOS
  498.  
  499.        then  SFC  will  be able to find the SFC.CFG & SFC.HLP files.  The
  500.        best approach is to put the  SET  environment  statement  in  your
  501.        AUTOEXEC.BAT  file.   The  use  of the SFC environment variable is
  502.        optional, but recommended.
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.       Users Manual                                           page 8
  528.  
  529.  
  530.  
  531.  
  532.        6.1 Startup Menu
  533.  
  534.        After startup, a menu will be  displayed  at  the  bottom  of  the
  535.        screen with 8 options. Use up and down arrow keys to move the menu
  536.        bar  --  use  ENTER  to  make selection. Note that on-line help is
  537.        available by typing function key 1 ( F1 ).
  538.  
  539.        CONNECT: Attempts to connect to the other computer. The baud  rate
  540.        must  be  the  same on both computers. If you mistakenly start SFC
  541.        with the  wrong  baud  rate  or  port,  type  "CTRL"  and  "BREAK"
  542.        simultaneously to kill SFC so that you can start over.
  543.  
  544.        SET  BAUD:  Allows the user to select the baud rate.  Choose 1200,
  545.        2400, 4800, 9600, 19200, 38400, 57600, or 115200 baud.
  546.  
  547.        SET  COM  PORT: Allows the user to select the communications port,
  548.        COM1 to COM4.  SFC uses the port addresses in the BIOS table.   If
  549.        you  have  hardware  installed  for  COM3  or COM4 you may need to
  550.        install the port addresses in this table.  See  section  5.0.   Of
  551.        course, hardware must exist for the port selected.
  552.  
  553.        SET  LPT PORT: Allows the user to select the printer port, LPT1 to
  554.        LPT3 for printing by the remote system.
  555.  
  556.        B&W or COLOR: The toggles between black and white and color  mode.
  557.        Use  "Save  Config."  (  see  below  ). When SFC is restarted, the
  558.        selected mode will be in effect.
  559.  
  560.        TOGGLE FLAGS: Allows the user to toggle each of the  five  runtime
  561.        options  (  ARC,  ASK, CHK, DIR, and R/O ). The current setting is
  562.        always displayed in the status area.   For  a  definition  of  the
  563.        runtime options, see section 6.3.
  564.  
  565.        SAVE CONFIG: After selected the baud rate, COM port, LPT port, and
  566.        B&W  or  color, use this selection to save the configuration.  The
  567.        next time that SFC is run, it will be initialized as configured.
  568.  
  569.        QUIT: Quits and returns to MSDOS.
  570.  
  571.        Set  the  port and/or baud rate on both computers if the default (
  572.        COM1 at 115200 is not acceptable. Then select the CONNECT  option.
  573.        SFC will now attempt connection to the other computer.
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.       Users Manual                                           page 9
  594.  
  595.  
  596.  
  597.  
  598.        6.2 Startup Problems
  599.  
  600.        If  the  message  "Connection completed" is not displayed then the
  601.        computers are not talking to each other. The problem may be one of
  602.        the following:
  603.  
  604.        (1) You must start SFC on both computers! SFC should be started on
  605.        both computers within one minute of each other.
  606.  
  607.        (2) The wrong port is selected. For example, if SFC is told to use
  608.        COM1 but COM2 is actually connected to the cable.
  609.  
  610.        (3) You may have selected different baud rates. They must match  !
  611.        Recall that the default baud rate is 115200.
  612.  
  613.        (4) You do not have a null  modem  cable  connecting  the  two.  A
  614.        normal cable ( without a null modem adapter ) will not work.  Test
  615.        the  null  modem  cable  by running TERM or any terminal emulation
  616.        program.  Whatever is typed on one side is displayed on the other.
  617.        If this does not happen then you have a  problem  with  your  null
  618.        modem cable.
  619.  
  620.        (5)  One  of  the computers may be configured as DCE ( in order to
  621.        talk to a serial printer ) instead of DTE ( in order to talk to  a
  622.        modem  ).   In this case, a normal cable ( instead of a null modem
  623.        cable ) will work.
  624.  
  625.        (6) Your serial port is defective. This is  unlikely.   Registered
  626.        users can run LOOPBACK to test the port.
  627.  
  628.        (7)  Your  COM ports are not defined sequentially. Your first port
  629.        must be COM1, the second COM2, etc. This means that you  shouldn't
  630.        have COM2 defined but not COM1.
  631.  
  632.        (8)  Your  PC  is  not  IBM hardware compatible!  For example, the
  633.        TANDY 2000 is not hardware compatible with respect to  the  serial
  634.        ports.
  635.  
  636.        Occasionally, SFC will run correctly for a while and then lock up.
  637.        This is almost always due to a marginal homemade null modem cable.
  638.        If  you  use SFC on a regular basis, then you should either buy or
  639.        make a SHIELDED cable. Remember that  typing  "CTRL"  and  "BREAK"
  640.        simultaneously  will  kill  SFC  if  you get hung up and the menus
  641.        don't work.
  642.  
  643.        If SFC will not connect, then use the manual mode on COM1 at  9600
  644.        baud:  Type  "SFC  M" on one computer and "SFC S" on the other. If
  645.        you still cannot get communication between  computers,  registered
  646.        users  can  call  the  technical  support  telephone  number (205)
  647.        881-4630 after 5:00 PM CST Monday through Friday or Saturday after
  648.        2:00 PM CST for assistance.
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.       Users Manual                                           page 10
  660.  
  661.  
  662.  
  663.  
  664.        6.3 Status Window
  665.  
  666.        The "Status" window contains information having  to  do  with  the
  667.        status of SFC. The definition of each field follows:
  668.  
  669.        PORT: The Communications port ( COM1 to COM4 ) is displayed.
  670.  
  671.        BAUD: The baud rate ( 1200 to 115200 ) is displayed.
  672.  
  673.        UNIT:  #  bytes  per  allocation unit is displayed. Space for disk
  674.        files is always allocated as a multiple of this value.
  675.  
  676.        DISK: The currently logged disk drive is displayed.
  677.  
  678.        PATH: The current directory path is displayed.
  679.  
  680.        MODE: Runtime mode is displayed.
  681.  
  682.        "ready"    --  Displayed when ready to accept keyboard input.
  683.        "MENU"     --  Displayed after having selected a menu command.
  684.        "send"     --  Displayed while sending files.
  685.        "receive"  --  Displayed while receiving files.
  686.  
  687.        FREE: Free disk space in bytes is displayed.
  688.  
  689.        Five  runtime  options  (  ARC,  ASK,  CHK,  DIR,  R/O  ) are also
  690.        displayed as either "On" or "Off".  All  options  can  be  toggled
  691.        between  "On"  and "Off" by use of the "Toggle Flags" selection of
  692.        the command menu ( See section 6.4 ). All flags are normally off.
  693.  
  694.        ASK: Asks the  user  for  permission  before  sending  each  file.
  695.        Typically  selected  when using wildcards in specifying a range of
  696.        files for which you wish to exclude some files.
  697.  
  698.        DIR: Enables sending of files in subdirectories (  recursively  ).
  699.        For  example, to send all "*.ASM" files on the C drive, select the
  700.        C drive and the root path, turn on the DIR  flag,  and  then  send
  701.        "*.ASM" with "Send File(s)".
  702.  
  703.        CHK:  Send  only  files  with  a later date & time if file already
  704.        exists.  Normally off, toggle this on if you want to do  a  backup
  705.        of more recently modified files. "...skipped(CHK)" is displayed if
  706.        the file is not copied because of the CHK option.
  707.  
  708.        ARC: Send only files where the ARCHIVE attribute is set, then turn
  709.        off  the ARCHIVE attribute.  An ARCHIVE attribute is maintained by
  710.        MSDOS for each file on your disk.  It is  automatically  set  each
  711.        time the file is written to and closed. Please refer to your MSDOS
  712.        manual.
  713.  
  714.        R/O:  Allows the sending of read only (R/O) files. Many users mark
  715.        their executable programs as read  only  using  the  MSDOS  ATTRIB
  716.        program.   Since one normally doesn't need to back up applications
  717.        and systems programs, the R/O flag provides  a  convenient  method
  718.        for excluding read only files from copies.
  719.  
  720.        Notes:  (1)  All options need only be set on the sending computer.
  721.        (2) Be sure that the clocks on your two computers are set  to  the
  722.        same  date  and  time  (  to within a few seconds ) if you plan on
  723.        using the CHK option.
  724.  
  725.       Users Manual                                           page 11
  726.  
  727.  
  728.  
  729.  
  730.        6.4 Command Menu
  731.  
  732.        The Command Menu contains the choices the user has  once  SFC  has
  733.        connected. Use the up and down arrow keys to move the menu bar and
  734.        ENTER  to  make  your  selection.   Once  one  of  the  choices is
  735.        selected, the user can return without SFC performing the  selected
  736.        function by typing the ESC key. Type the F1 function key for help.
  737.  
  738.        QUIT: Quits SFC and returns to MSDOS.
  739.  
  740.        SET  CURRENT DRIVE: Changes the currently selected drive. The user
  741.        can "log onto" any legal DOS drive ( A, B, etc. ). If  you  change
  742.        diskettes  then you must always select the SET DRIVE option before
  743.        continuing.
  744.  
  745.        SET CURRENT PATH: Changes the currently selected path.  When  this
  746.        option  is selected, a "Enter Path:" prompt is displayed. The user
  747.        then edits the current path which is displayed.
  748.  
  749.        All paths must start with a backslash ( full path name ). When the
  750.        user is satisfied, typing ENTER will save the  path.   Then  MSDOS
  751.        will  attempt to change the "current" path. If successful, the new
  752.        path will be displayed in the "Status" window.
  753.  
  754.        DIRECTORY: Displays a directory of  files  requested.   When  this
  755.        option  is selected, a "Enter files" prompt is displayed. The user
  756.        then types the file or files ( using the MSDOS wildcards *  and  ?
  757.        ). Filenames can be edited similarly to paths.
  758.  
  759.        SEND FILE(S): Sends files to the other computer. No special action
  760.        is required on the receiving side except that both sides must have
  761.        previously  selected  CONNECT.   The user will be prompted for the
  762.        filename  in  the  same  way  as  when  "Directory"  was  selected
  763.        including  the  use of the MSDOS wildcards * and ?. If you specify
  764.        that a directory is to be sent and the DIR option is set to  "On",
  765.        then  all  files in that directory ( including other directories )
  766.        will be sent. In this  way  entire  directory  structures  can  be
  767.        copied. The date and time for normal files ( but not directories )
  768.        will be preserved.
  769.  
  770.        An  indirect  file can also be specified by prefixing the filename
  771.        by the '@' character. An indirect file is a  standard  ASCII  text
  772.        file  containing  the  list of files to be sent. The indirect file
  773.        must have been previously prepared  and  contain  one  filename  (
  774.        wildcards  accepted  ) per line. Indirect files are typically used
  775.        to specify a list of files  that  are  transferred  on  a  regular
  776.        basis.
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.       Users Manual                                           page 12
  792.  
  793.  
  794.  
  795.  
  796.        REMOTE  PRINT:  Sends  the  specified file to the remote ( other )
  797.        computer for printing.  No wildcards are  allowed.   The  printing
  798.        can  be  canceled  at any time by typing any key before the normal
  799.        end of the print job.
  800.  
  801.        TOGGLE FLAGS: Allows the user to toggle each of the  five  runtime
  802.        options  (  ARC,  ASK, CHK, DIR, and R/O ). The current setting is
  803.        always displayed in the status area.   For  a  definition  of  the
  804.        runtime options, see section 6.3.
  805.  
  806.        DOS  SHELL:  Loads the DOS shell, allowing the user to execute DOS
  807.        commands. The user must be very careful not to execute any command
  808.        that changes the serial ports or modifies the screen  environment.
  809.        Please  note  that  many application programs do change the screen
  810.        environment. It is safer to stay with the  standard  DOS  commands
  811.        unless  a  particular  executable has been previously tested.  Use
  812.        the MSDOS EXIT command to return to SFC.
  813.  
  814.        When entering text in response to any of the above commands,  type
  815.        ESC  to return back to the main menu without selecting. The editor
  816.        starts in "Overstrike" mode ( each typed  character  overlays  the
  817.        previous  character ), but can be switched to "Insert" mode ( each
  818.        typed character is inserted at the cursor, shifting all characters
  819.        to the right over one space) by typing  the  INSERT  key  (  which
  820.        toggles  between  Overstrike  and  Insert  mode ).  The DELETE key
  821.        deletes the character underneath the cursor. The END key moves the
  822.        cursor to the end of the string, while  the  HOME  key  moves  the
  823.        cursor to the start of the string.
  824.  
  825.        6.5 Terminating SFC
  826.  
  827.        A series of files being transmitted can be  terminated  (  without
  828.        aborting  the  system  )  by typing ESC on the sending side during
  829.        transmission. The user will be returned to the SFC menu after  the
  830.        completion of the current file transmission.
  831.  
  832.        The user may break out of SFC at any time and return to  MSDOS  by
  833.        typing  "CTRL"  and  "BREAK"  simultaneously.  This should only be
  834.        used when the program hangs for  some  reason  and  SFC  does  not
  835.        respond to the keyboard. Always try to use the menu selection QUIT
  836.        to quit SFC and return to MSDOS rather than Control Break.
  837.  
  838.        6.6 CRC Calculations
  839.  
  840.        A  full  16  bit Cyclic Redundancy Check ( CRC ) using the CCITT (
  841.        The  Consultative  Committee  in  International   Telegraphy   and
  842.        Telephony  )  polynomial  is  used by SFC. The CRC of each file is
  843.        computed before transmission by the sender and sent along with the
  844.        file being transmitted. The receiver then computes the CRC of  the
  845.        received  file and compares it to the CRC sent. If the CRCs match,
  846.        then the file is considered to be correct and a "OK" is displayed.
  847.        CRC calculations are considered to be the  best  available  method
  848.        for  verifing  data integrity. They are much superior to checksums
  849.        and detect 99.99 percent of data errors. If an error is  detected,
  850.        the offending packet ( part of the file ) will be re-transmitted
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.       Users Manual                                           page 13
  858.  
  859.  
  860.  
  861.  
  862.        7.0 Support Programs
  863.  
  864.        The  following  support programs are not necessary in order to run
  865.        SFC but are provided as a "Thank You" for registered users.
  866.  
  867.        7.1 CLONE, PUTSFC, and PUTSFC.
  868.  
  869.        Don't have SFC  on  the  target  computer  ?   The  CLONE  program
  870.        provides  a  way to 'clone' SFC onto another computer. The program
  871.        PUTSFC is used to send a copy of SFC to GETSFC which is created by
  872.        CLONE on the target computer. With CLONE you only need  your  null
  873.        modem  cable to connect to computers with a different disk format.
  874.        Cloning is fully described in CLONE.DOC.
  875.  
  876.        7.2 LOOPBACK
  877.  
  878.        If you suspect that your serial port may be  defective,  then  use
  879.        LOOPBACK  to  test the internal circuitry. The serial ports have a
  880.        built in 'loop back' test capability which is used by the LOOPBACK
  881.        program. For example, to test the COM1 port, type 'LOOPBACK 1'
  882.  
  883.        7.3 TERM
  884.  
  885.        Need a simple communications program to test your null modem cable
  886.        ?  TERM is a terminal emulator program in which  everything  typed
  887.        on one machine is displayed on the other, and vice versa.  Connect
  888.        your  two  computers together with a null modem cable and then run
  889.        TERM on each side. Usage is "TERM port baud" where port =  1,2,3,4
  890.        and  baud  =  1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200.
  891.        For example, type "TERM 1 1200" for COM1 at 1200 baud.
  892.  
  893.        7.4 MODEM
  894.  
  895.        The MODEM program is used to turn the modem control lines DTR  and
  896.        RTS  on  and off, and to display DTR, DSR, RTS, and CTS. MODEM can
  897.        help you test out your null modem cable. For example, to work with
  898.        COM3, type 'MODEM 3'. A  menu  will  be  displayed  providing  all
  899.        options.
  900.  
  901.        7.5 PORTEXAM
  902.  
  903.        The  PORTEXAM  program  will  tell you all you ever wanted to know
  904.        about the status of any serial port. It reports  the  serial  port
  905.        address,  the  interrupt vector, the location of the ISR code, the
  906.        status of all modem control and modem status  lines,  and  if  the
  907.        serial  interrupt  is  enabled.   Very  useful  as a cable testing
  908.        program and for advanced users. For example, to examine COM1  type
  909.        'PORTEXAM  1'.   PORTEXAM  does  not  reset  the  port so that the
  910.        "current" status of the port can be examined.
  911.  
  912.        7.6 CHECKCRC
  913.  
  914.        The CHECKCRC program is used  to  compute  the  Cyclic  Redundancy
  915.        Check ( CRC ) of any file ( sort of a 16-bit file 'fingerprint' ).
  916.        For  example,  to  compute  the  CRC  of all files ending with the
  917.        extension .DOC type 'CHECKCRC *.DOC'. Use the CHECKCRC program  to
  918.        verify that two copies of the same file are indeed the same file.
  919.  
  920.  
  921.  
  922.  
  923.       Users Manual                                           page 14
  924.  
  925.  
  926.  
  927.  
  928.        7.7 GETFILE/PUTFILE
  929.  
  930.        Your computer not IBM compatible ? Then GETFILE and PUTFILE may be
  931.        your  answer.  GETFILE  and  PUTFILE are BIOS driven file transfer
  932.        programs.  They make use of the computer's BIOS so that any  MSDOS
  933.        computer with a serial port configured for a modem will work, even
  934.        though the computer is not IBM hardware compatible.
  935.  
  936.        To  begin,  you  MUST  have  a null modem cable connecting the two
  937.        machines. The signal ground must be present, transmit and  receive
  938.        must  be  reversed, DTR should be connected to both DSR and CTS on
  939.        the other side. Thus, you will have a 5 wire cable  as  diagrammed
  940.        below.
  941.  
  942.              SG o----------o SG
  943.              TX o----------> RX
  944.              RX <----------o TX
  945.             DTR o----------> DSR+CTS
  946.         DSR+CTS <----------o DTR
  947.  
  948.        This requirement is dictated by your BIOS software. Unfortunately,
  949.        some  commercial  null  modem  cables  are not fully wired because
  950.        communication programs for IBM compatibles never use the BIOS !
  951.  
  952.        Start  GETFILE  on  the  receiving computer first. For example, to
  953.        use COM3 type:
  954.  
  955.           GETFILE 3
  956.  
  957.        If you get any error, then try it again.  Next  start  PUTFILE  on
  958.        the source computer. For example, to use COM1 type:
  959.  
  960.           PUTFILE 1
  961.  
  962.        PUTFILE should prompt you for a filename. Wildcards are  OK.   For
  963.        example,  to  send  all  files  ending  in ".PAS", type "*.PAS" --
  964.        without the quote marks. When no more files are to be  sent,  just
  965.        type  ENTER  on  the  PUTFILE  side  to terminate both GETFILE and
  966.        PUTFILE.
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.       Users Manual                                           page 15
  990.  
  991.  
  992.  
  993.  
  994.        7.8 DRIVES
  995.  
  996.        Need a quick and easy way to determine how much free disk space is
  997.        available ? DRIVES is a utility program that will list the  volume
  998.        label,  total space and used space in kilobytes or megabytes for a
  999.        specified range of logical drives. This is  particularly  helpfull
  1000.        when your system has more than one logical hard drive.
  1001.  
  1002.        DRIVES C       -- Display disk usage for drive C.
  1003.        DRIVES C F     -- Displays disk usage for drives C through F.
  1004.        DRIVES A Z     -- Displays disk usage for all drives on system.
  1005.  
  1006.        7.9 SETCOM3 and SETCOM4
  1007.  
  1008.        Got COM3 and/or COM4 serial port hardware but SFC and other serial
  1009.        programs  don't  know its there ? The BIOS table is not updated by
  1010.        MSDOS ( through version 3.3 ) as is the case for  COM1  and  COM2.
  1011.        SETCOM3  updates  the  BIOS table for COM3 if you have serial port
  1012.        hardware installed at the standard COM3 address 03E8.  Similiarly,
  1013.        use  SETCOM4  if  you  have  serial port hardware installed at the
  1014.        standard COM4 address 02E8. Place SETCOM3 and/or SETCOM4  in  your
  1015.        AUTOEXEC.BAT   file   so  that  the  BIOS  table  can  be  updated
  1016.        automatically at bootup.
  1017.  
  1018.        7.10 FLAGS
  1019.  
  1020.        Need an easy way to examine, set,  and  clear  the  ARCHIVE,  READ
  1021.        ONLY,  and  HIDDEN  attributes  of  your files?  Later versions of
  1022.        MSDOS provide the ATTRIB utility, which does the same thing except
  1023.        for hidden files. But if you don't have ATTRIB or want  to  change
  1024.        the  HIDDEN  attribute,  use  FLAGS. For example, "FLAGS +H *.SAV"
  1025.        sets the hidden attribute of all files ending  in  "SAV",  whereas
  1026.        "FLAGS  -H  *.SAV"  clears  the  hidden attribute.  Use R for READ
  1027.        ONLY, H for HIDDEN, and A for ARCHIVE attributes.
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.       Users Manual                                           page 16
  1056.  
  1057.  
  1058.  
  1059.  
  1060.        8.0 Performance
  1061.  
  1062.        The following benchmark results were obtained using a Tandy 1000 (
  1063.        4.77  MHZ),  a Tandy 1400LT ( 4.77 & 9.16 MHZ ), a Tandy 3000 ( 10
  1064.        MHZ ) computer, and a Gateway 2000 Cache computer ( 25  MHZ  80386
  1065.        DX  ).  Note that the 'standard' IBM PC runs at 4.77 MHZ.  Virtual
  1066.        disks ( ramdisks ) were used in order to  measure  performance  as
  1067.        independent  of disk speed as possible. The use of hard disks will
  1068.        result in a little slower times than shown while the use of floppy
  1069.        disks will result  in  much  slower  times.   The  use  of  faster
  1070.        computers  will  result  in  faster times than shown.  Three files
  1071.        were used: file A is 10,000 bytes long, file B is 50,000 bytes and
  1072.        file C is 100,000 bytes long. All times are  in  seconds  and  are
  1073.        from  start  to  finish  including  ramdisk access. A baud rate of
  1074.        115200 is used  for  all  tests.   Your  results  should  be  very
  1075.        similiar.
  1076.  
  1077.        8.1 Test Results
  1078.  
  1079.        +==============+==============+==========+==========+==========+
  1080.        |   Source     | Destination  |  File A  |  File B  |  File C  |
  1081.        +==============+==============+==========+==========+==========+
  1082.        | Tandy 3000   | Tandy 1000   |   2.2    |   9.8    |   14.7   |
  1083.        +--------------+--------------+----------+----------+----------+
  1084.        | Tandy 3000   | Tandy 1400LT |   1.6    |   6.7    |   12.7   |
  1085.        +--------------+--------------+----------+----------+----------+
  1086.        | Tandy 1400LT | Tandy 3000   |   1.5    |   6.1    |   12.1   |
  1087.        +--------------+--------------+----------+----------+----------+
  1088.        | Tandy 3000   | Gateway 2000 |   1.25   |   5.2    |   10.1   |
  1089.        +--------------+--------------+----------+----------+----------+
  1090.  
  1091.        8.2 Other Tests
  1092.  
  1093.        The author has personally tested SFC on a TANDY 1000, TANDY  3000,
  1094.        TANDY 1400LT, and a 25 MHZ Gateway-2000 386DX Cache Computer.
  1095.  
  1096.        Serial File  Copy  has  been  benchmarked  against  several  other
  1097.        shareware  programs.  All that we have tried ( 3 ) are slower when
  1098.        using the same baud rate. One program took almost twice as long to
  1099.        transfer files. If anyone finds a  faster  file  transfer  utility
  1100.        than SFC please write or call!
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.       Users Manual                                           page 17
  1122.  
  1123.  
  1124.  
  1125.  
  1126.        9.0 Using SFC to back up HARD DISKS
  1127.  
  1128.        SFC  is  an  easy  way  to back up one hard disk onto another hard
  1129.        disk.  Of course, there must be sufficient room on  the  receiving
  1130.        disk.
  1131.  
  1132.        Normally,  you  only  need  to  back  up your work files that have
  1133.        changed since your last backup. You should have the masters of any
  1134.        application programs backed up to disk separately.
  1135.  
  1136.        To begin, it is usually a  good  idea  to  mark  your  system  and
  1137.        application  files  as  "READ  ONLY"  (R/O) using the MSDOS ATTRIB
  1138.        command. Registered users can  use  the  FLAGS  utility  for  this
  1139.        purpose  if  ATTRIB  is  not available. Unless the SFC R/O flag is
  1140.        set, these files will always be skipped by SFC. By the way, making
  1141.        your files "read only" affords you some degree of  computer  virus
  1142.        protection.
  1143.  
  1144.        The CHK flag can be used which will only allow copying a file with
  1145.        a  more  recent  time  and date on the source computer than on the
  1146.        destination computer. If you use this method,  be  sure  that  the
  1147.        clocks  on  your two computers are reasonably close - within a few
  1148.        seconds if you will be backing up  immediately  after  updating  a
  1149.        file.
  1150.  
  1151.        Alternately,  the  SFC  ARC  flag can be set which will only allow
  1152.        copying a file that has not been written to  since  the  last  SFC
  1153.        copy.   SFC  does  this  by only copying files with the MSDOS file
  1154.        ARCHIVE attribute set, then  clearing  this  attribute.   However,
  1155.        please note that MSDOS commands like BACKUP also clear the ARCHIVE
  1156.        attribute.   This  means that if you use BACKUP or some commercial
  1157.        backup program to make backups, don't use the ARC  flag  with  SFC
  1158.        unless  you  know  what  you  are  doing.  To backup one disk onto
  1159.        another, follow these steps.
  1160.  
  1161.        1) Start SFC on both machines.
  1162.  
  1163.        2) Select the proper drive and path on the source machine. To back
  1164.        up the entire disk, select the root path.
  1165.  
  1166.        3) Select the proper drive and path on  the  destination  machine.
  1167.        All  files  will  be  copied  to  the  directory  specified on the
  1168.        destination machine.
  1169.  
  1170.        4) Set the DIR flag to Y using the "Toggle Flags" menu item on the
  1171.        source machine. This enables copying of directories.
  1172.  
  1173.        5) Select "Send File(s)" and type "*.*" on the source machine.
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.       Users Manual                                           page 18
  1188.  
  1189.  
  1190.  
  1191.  
  1192.        10.0 User Registration
  1193.  
  1194.        The  shareware  version  of  SFC  is  provided  so  that  you  may
  1195.        personally  determine  the  usefulness of SFC for yourself. If you
  1196.        can use SFC  please  register  your  use  with  us.   Registration
  1197.        entitles  the  user  to  install  SFC  on  up to 2 computers. Site
  1198.        licenses are available for situations where SFC will be  installed
  1199.        on  more  than 2 computers. Call for prices. To register SFC, send
  1200.        $25 plus $3 S&H ( $6 outside of USA, Canada, and Mexico ) to:
  1201.  
  1202.        MarshallSoft Computing, Inc.
  1203.        P.O.  Box  4543
  1204.        Huntsville AL 35815
  1205.  
  1206.        Please pay by check in US dollars. If your check is made out on  a
  1207.        bank   outside  of  the  USA,  please  include  any  foreign  bank
  1208.        collection fee that your bank  charges.   Payment  must  accompany
  1209.        purchase  orders.  Print the file SFC.INV if an invoice is needed.
  1210.        The registered package includes:
  1211.  
  1212.        o  Latest version of SFC.
  1213.        o  No shareware screens.
  1214.        o  All 12+ support programs - See 'Support Programs' section.
  1215.        o  Notices of new versions.
  1216.        o  One year telephone support ( voice ).
  1217.        o  Backbone bound printed Users Manual.
  1218.  
  1219.        The registered user will receive  the  latest  version  by  return
  1220.        mail.  A  360  KB  5.25" diskette will be provided unless a 720 KB
  1221.        3.5" diskette is requested when ordering.
  1222.  
  1223.        For  those  not  yet  ready  to register SFC, a "Users License" is
  1224.        available for $5.  This entitles the purchaser to the use  of  the
  1225.        shareware  version  of SFC.  The user will also receive notices of
  1226.        new versions of SFC and other MarshallSoft Computing products. The
  1227.        $5 can also be applied to any future registration.
  1228.  
  1229.        The latest shareware version is always available for $7.50 ( which
  1230.        includes a $5 Users  License  ).   A  360  KB  5.25"  diskette  is
  1231.        provided  unless a 720 KB 3.5 diskette is requested when ordering.
  1232.        Order both media for $8.50.
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.       Users Manual                                           page 19
  1254.  
  1255.  
  1256.  
  1257.  
  1258.        11.0 Revision History
  1259.  
  1260.        Version 1.0 -- 10 April 1989
  1261.  
  1262.        Original release
  1263.  
  1264.        Version 1.1 -- 30 July 1989
  1265.  
  1266.        Added ASK and CHK options.
  1267.        Moved DIR option from separate menu item to options menu.
  1268.        Fixed bug in disk file size reporting.
  1269.        Changed units of FREE from kilobytes to bytes.
  1270.        Changed internal parameters for  easier  synchronization.
  1271.        Increased  PATH length from 58 to a full 64 characters.
  1272.        SLAVE side must start SFC with "SFC  /S".
  1273.        Could not generate backslash on Tandy 1000.
  1274.  
  1275.        Version 1.2  --  16 October 1989 ( no shareware version )
  1276.  
  1277.        Added a new AUTOSYNC mode as well as manual startup mode.
  1278.        Added help file support.
  1279.        Greatly expanded documention file.
  1280.  
  1281.        Version 1.3  -- 1 November 1989 ( no shareware version )
  1282.  
  1283.        Fixed problem with port COM2.
  1284.        Support the port and baud rate specified on command line.
  1285.        Simplified operation of AUTOSYNC.
  1286.        Added indirect file ( '@' file ) support.
  1287.        Added support for COM3 and COM4.
  1288.  
  1289.        Version 2.0  -- 10 November 1989
  1290.  
  1291.        Internal change to allow 4.77 MHZ PCs to run at 115200.
  1292.        Allows transfer of read only files.
  1293.  
  1294.        Version 2.1 -- 16 February 1990
  1295.  
  1296.        Added DOS Shell menu option.
  1297.        Modified AUTOSYNC for increased reliability.
  1298.        Increased buffer size to 2000 bytes for 57600 & 115200 baud.
  1299.        Provide cloning program and other supporting programs.
  1300.        Added ability to do remote printing.
  1301.        'NO RESPONSE' error does not abort system.
  1302.        Fixed error in sending files > 50KB ( affected version 2.0 only )
  1303.  
  1304.        Version 2.2 -- 15 May 1990 ( no shareware version )
  1305.  
  1306.        Changing drives clears file message string back to "*.*".
  1307.        Minor changes and bug fixes.
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.       Users Manual                                           page 20
  1320.  
  1321.  
  1322.  
  1323.  
  1324.        Version 3.0 -- 11 Aug 1990
  1325.  
  1326.        Supports both B&W and color displays.
  1327.        Supports configuration file (SFC.CFG)
  1328.        Added ARCHIVE & R/O flags to options.
  1329.  
  1330.        Version 3.1 -- 11 March 1991
  1331.  
  1332.        Added SFC environment variable.
  1333.        Fixed potential problem with color mode when SFC.CFG is missing.
  1334.        Shareware version now runs at 115200 baud.
  1335.  
  1336.        Version 3.2 -- 24 Nov 1991
  1337.  
  1338.        Removed directory stack limit of 50 sub-directories.
  1339.        Sub-directory ordering is always preserved.
  1340.        Work around for DOS 5.0 bug (when asking for help) implemented.
  1341.  
  1342.        MarshallSoft incorporated on December 23, 1991.
  1343.  
  1344.        Version 3.3 -- 10 February 1992.
  1345.  
  1346.        Fixed  bug  in 3.2 which occurred when copying directories starting
  1347.        from a subdirectory ( not the root ).
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.       Users Manual                                           page 21
  1386.  
  1387.  
  1388.  
  1389.  
  1390.        12.0 Other MarshallSoft Computing Products
  1391.  
  1392.        A shareware disk containing all MarshallSoft programs (  described
  1393.        below  ) is available for US $7.50 drawn on a US bank ($10 outside
  1394.        of the US, Canada, and Mexico). A 360 KB disk is provided unless a
  1395.        720KB disk is specified.
  1396.  
  1397.        12.1 Personal Communications Library for C ( PCL4C )
  1398.  
  1399.        The  Personal  Communications Library for the C Language ( PCL4C )
  1400.        is an asynchronous communications library designed for experienced
  1401.        software  developers  programming  in  C.   Four   compilers   are
  1402.        supported:  Microsoft  Optimizing  C,  Microsoft  Quick C, Borland
  1403.        Turbo C, and MIX Power  C.   An  IBM  PC/XT/AT  or  compatible  is
  1404.        required.
  1405.  
  1406.        The  PCL features SMALL, COMPACT, MEDIUM & LARGE memory models, 29
  1407.        communication and support functions,  interrupt  driven  receiver,
  1408.        support  for  300  through  115200  baud, support for COM1 through
  1409.        COM4,  adjustable  receive  queues  from  8  bytes   to   16   KB,
  1410.        control-BREAK   error  exit,  12  communication  error  conditions
  1411.        trapped, ability to  run  2  ports  concurrently,  complete  modem
  1412.        control  &  status,  and 8 example programs ( including a terminal
  1413.        emulator with XMODEM & YMODEM ).
  1414.  
  1415.        Registration for PCL4C is $45 plus $3 S&H ($6 outside of the  USA,
  1416.        Canada,   and   Mexico),   and   includes  printed  documentation,
  1417.        libraries without the shareware screen, and SOURCE  code  for  the
  1418.        library.
  1419.  
  1420.        12.2 Personal Communications Library for Pascal ( PCL4P )
  1421.  
  1422.        The  Personal  Communications  Library  for Pascal ( PCL4P ) is an
  1423.        asynchronous  communications  library  designed  for   experienced
  1424.        software  developers programming in Turbo Pascal ( version 4.0 and
  1425.        up).  An IBM PC/XT/AT or compatible is required.
  1426.  
  1427.        The  PCL4P  features  16  communications  and  support  functions,
  1428.        interrupt  driven  receiver,  support for 300 baud to 115200 baud,
  1429.        support for COM1 through COM4, adjustable receive  queues  from  8
  1430.        bytes to 16 KB, control-BREAK error exit, 12 comm error conditions
  1431.        trapped,  ability  to  run  2  ports  concurrently, complete modem
  1432.        control & status.
  1433.  
  1434.        A simple terminal emulator program TERM.PAS  (featuring  XMODEM  &
  1435.        YMODEM  file  transfer)  is  provided  in  source  code form as an
  1436.        example of the use  of  PCL4P  functions.  Several  other  example
  1437.        programs are also provided.
  1438.  
  1439.        Registration  for PCL4P is $45 plus $3 S&H ($6 outside of the USA,
  1440.        Canada, an Mexico) and includes printed documentation,  a  library
  1441.        without the shareware screen, and SOURCE code for the library.
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.       Users Manual                                           page 22
  1452.  
  1453.  
  1454.  
  1455.  
  1456.        13.0 License
  1457.  
  1458.        This  software  and the disks on which it is contained is licensed
  1459.        to you, for your own use. This is copyrighted  software.  You  are
  1460.        not  obtaining  title to the software or any copyright rights. You
  1461.        may  not  sublicense,  rent,  lease,  convey,  modify,  translate,
  1462.        or convert this software for any purpose.
  1463.  
  1464.        You  may  make  as  many  copies  of this software as you need for
  1465.        backup purposes. You may use this software on  no  more  than  two
  1466.        computers  at  any  one  time. If you need to use this software on
  1467.        more than two computers simultaneously,  please  contact  use  for
  1468.        information about site licenses.
  1469.  
  1470.        14.0 Warranty
  1471.  
  1472.        MARSHALLSOFT COMPUTING, INC. DISCLAIMS ALL WARRANTIES RELATING  TO
  1473.        THIS  SOFTWARE,  WHETHER  EXPRESSED  OR IMPLIED, INCLUDING BUT NOT
  1474.        LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY  AND  FITNESS
  1475.        FOR  A  PARTICULAR  PURPOSE, AND ALL SUCH WARRANTIES ARE EXPRESSLY
  1476.        AND SPECIFICALLY DISCLAIMED. NEITHER MARSHALLSOFT COMPUTING,  INC.
  1477.        NOR ANYONE ELSE WHO HAS BEEN INVOLVED IN THE CREATION, PRODUCTION,
  1478.        OR  DELIVERY  OF  THIS  SOFTWARE SHALL BE LIABLE FOR ANY INDIRECT,
  1479.        CONSEQUENTIAL, OR INCIDENTAL DAMAGES ARISING OUT  OF  THE  USE  OR
  1480.        INABILITY  TO  USE  SUCH  SOFTWARE EVEN IF MARSHALLSOFT COMPUTING,
  1481.        INC.  HAS BEEN ADVISED OF  THE  POSSIBILITY  OF  SUCH  DAMAGES  OR
  1482.        CLAIMS. IN NO EVENT SHALL MARSHALLSOFT COMPUTING, INC.'S LIABILITY
  1483.        FOR ANY SUCH DAMAGES EVER EXCEED THE PRICE PAID FOR THE LICENSE TO
  1484.        USE  THE SOFTWARE, REGARDLESS OF THE FORM OF THE CLAIM. THE PERSON
  1485.        USING  THE  SOFTWARE  BEARS  ALL  RISK  AS  TO  THE  QUALITY   AND
  1486.        PERFORMANCE OF THE SOFTWARE.
  1487.  
  1488.        Some  states  do not allow the exclusion of the limit of liability
  1489.        for consequential or incidental damages, so the  above  limitation
  1490.        may not apply to you.
  1491.  
  1492.        This  agreement  shall  be  governed  by  the laws of the State of
  1493.        Alabama and shall inure to the benefit of Marshallsoft  Computing,
  1494.        Inc.   and  any successors, administrators, heirs and assigns. Any
  1495.        action or proceeding brought by either  party  against  the  other
  1496.        arising  out of or related to this agreement shall be brought only
  1497.        in a STATE or FEDERAL COURT of competent jurisdiction  located  in
  1498.        Madison County, Alabama. The parties hereby consent to in personam
  1499.        jurisdiction of said courts.
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.       Users Manual                                           page 23
  1518.  
  1519.  
  1520.  
  1521.  
  1522.